package cn.iocoder.yudao.framework.location;

import cn.iocoder.yudao.framework.common.exception.KnownServiceException;
import jakarta.annotation.Nonnull;

/**
 * 定位客户端
 *
 * @author 山野羡民（1032694760@qq.com）
 */
public interface LocationClient {

    /**
     * 根据经纬度获取地理位置
     *
     * @param longitude 经度，如：106.690801
     * @param latitude  纬度，如：26.567322
     * @throws KnownServiceException 获取失败
     * @return 行政区域
     */
    @Nonnull
    LocationInfo getLocation(Double longitude, Double latitude) throws KnownServiceException;

}
